支付 Order 对象

通过该接口对待支付的 order 对象发起一次支付请求,每次请求时需指定用户付款的支付渠道。可以通过多次调用切换付款的渠道,同时生成多个 charge 对象。如果使用测试模式的 API Key,则不会发生真实交易。订单付款完成后,会发送 Webhooks 通知。

请求参数描述
ORDER_ID required stringPing++ 返回的 order 对象的 id,用于商品订单查询、退款,该参数仅需要填写在请求地址内。
charge_amount required int支付金额,单位分(大于 0,仅优惠券全额抵扣时可填 0)。和组合支付的金额(无组合支付则忽略)相加后,值必须等于订单中的应付金额 - 已付金额 + 已退金额。
channel required string支付使用的渠道(优惠券全额抵扣时,可不填)。渠道详情请参考 支付渠道属性值,若创建订单时传入了 balance_settlement,则此处不可使用 balance 渠道。除此之外,还支持使用自定义渠道 custom,该渠道不需要真实付款,并且会同步返回成功结果。
extra conditional hash特定渠道发起交易时需要的额外参数,以及部分渠道支付成功返回的额外参数,详细参考 支付渠道 extra 参数说明
charge_order_no optional string支付使用的商户订单号,默认使用订单对象中的商户订单号。当商户订单号在渠道被使用时,需更换新的商户订单号。推荐使用 8-20 位,要求数字或字母,不允许特殊字符。
time_expire optional timestamp订单失效时间的 Unix 时间戳。时间范围在订单创建后的 1 分钟到 24 小时,创建时间以 Ping++ 服务器时间为准。默认值为订单过期时间或渠道支持的最大过期时间中较小的那一个,但不会超过 24 小时。微信默认为 2 小时,wx_wap 渠道对该参数的有效值限制为 5 分钟;upacp、upacp_pc、upacp_wap、cp_b2b、applepay_upacp 渠道对该参数的有效值限制为 1 小时内;upacp_b2b 对该参数的有效值限制为 1 天内;upacp_qr 渠道对该参数的有效期默认为 1 天,最大为 30 天;此参数对 paypalscan 类渠道无效。
combined_with optional hash组合支付信息。组合支付是指该次支付和另一渠道共同支付完成,目前仅支持和余额组合支付,如果订单存在未全额退款的 Charge 对象则不能组合支付。详见下方的 combined_with 参数说明

combined_with 参数说明

参数说明
channel required string支付使用的另一个渠道。不能和支付的 channel 相同,目前仅支持 balance
charge_amount required int支付金额(必须大于 0)。单位分,该金额必须小于订单应付金额。
charge_order_no optional string该渠道使用的商户订单号,默认和支付的 charge_order_no 值相同。推荐使用 8-20 位,要求数字或字母,不允许特殊字符。

返回

返回一个 order 对象,或者返回一个错误,详见 错误

定义

POST https://api.pingxx.com/v1/orders/{ORDER_ID}/pay
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/orders/2001608270000004428/pay \
-H "Pingplusplus-Signature: SIGNATURE" \
-H "Pingplusplus-Request-Timestamp: 1475029155" \
-H "Content-Type: application/json" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
-d '{
	"channel": "alipay_qr",
  	"charge_amount": 800
  	}'
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
    "id": "2001708140000017551",
    "object": "order",
    "created": 1502695388,
    "livemode": false,
    "paid": false,
    "refunded": false,
    "status": "created",
    "app": "app_1Gqj58ynP0mHeX1q",
    "uid": "user_007",
    "available_balance": 0,
    "merchant_order_no": "2017081400000006",
    "amount": 1000,
    "actual_amount": 800,
    "amount_refunded": 0,
    "amount_paid": 0,
    "coupon_amount": 200,
    "currency": "cny",
    "subject": "Your Subject",
    "body": "Your Body",
    "client_ip": "127.0.0.1",
    "time_paid": null,
    "time_expire": 1502781019,
    "coupon": "300317081415225500002001",
    "description": "",
    "metadata": {},
    "charge_essentials": {
        "channel": "alipay_qr",
        "transaction_no": null,
        "failure_code": null,
        "failure_msg": null,
        "credential": {
            "object": "credential",
            "alipay_qr": "http://sissi.pingxx.com/mock.php?ch_id=ch_1Kyn50DyjXbHbvnv5SGK4qDK&channel=alipay_qr"
        },
        "extra": {}
    },
    "receipt_app": "app_1Gqj58ynP0mHeX1q",
    "service_app": "app_1Gqj58ynP0mHeX1q",
    "available_methods": [
        "balance"
    ],
    "charges": {
        "object": "list",
        "url": "/v1/charges",
        "has_more": false,
        "data": [
            {
                "id": "ch_1Kyn50DyjXbHbvnv5SGK4qDK",
                "object": "charge",
                "created": 1502695440,
                "livemode": false,
                "paid": false,
                "refunded": false,
                "reversed": false,
                "app": "app_1Gqj58ynP0mHeX1q",
                "channel": "alipay_qr",
                "order_no": "2017081400000006",
                "client_ip": "127.0.0.1",
                "amount": 800,
                "amount_settle": 800,
                "currency": "cny",
                "subject": "Your Subject",
                "body": "Your Body",
                "extra": {},
                "time_paid": null,
                "time_expire": 1502781019,
                "time_settle": null,
                "transaction_no": null,
                "refunds": null,
                "amount_refunded": 0,
                "failure_code": null,
                "failure_msg": null,
                "metadata": {},
                "credential": {
                    "object": "credential",
                    "alipay_qr": "http://sissi.pingxx.com/mock.php?ch_id=ch_1Kyn50DyjXbHbvnv5SGK4qDK&channel=alipay_qr"
                },
                "description": null
            }
        ]
    }
}